home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 501-525 / disk_518 / amidock / amidock.readme < prev    next >
Text File  |  1992-05-06  |  11KB  |  251 lines

  1.                                   AmiDock
  2.  
  3.                                 version 1.3
  4.  
  5.                                   03/10/91
  6.  
  7.                                by Gary Knight
  8.  
  9.  
  10.   What is AmiDock?  For those of you familar with the NeXT computer this 
  11. will be a short explanation. AmiDock is an Amiga version of the NeXT's Dock.
  12. AmiDock is (of course) more versatile and  not as limited as it's NeXT cousin. 
  13.  
  14.   OK, now for those of you not familar with the NeXT computer. AmiDock
  15. will provide you with a number of buttons on the WorkBench screen that when 
  16. pressed will launch other programs. These buttons are fully configurable to run 
  17. any program you want with a single press.
  18.  
  19.   Here a a brief run down of the features of AmiDock:
  20.  
  21.     * AmiDock can run programs that need a CLI or the WorkBench.
  22.  
  23.     * AmiDock uses IFF brushes for the button imagery. The brushes used are
  24.       standard IFF files and can be customized to your individual wants and
  25.       desires. In fact many of the programs you will add to the dock will need a
  26.       brush created for them. I have included a Dock Image Grid for this
  27.       purpose, but more about that later.
  28.  
  29.     * AmiDock is compatible with WorkBench 1.2, 1.3, and 2.0 and will run on
  30.           any Amiga computer with any amount of memory. AmiDock has been tested
  31.           on all Amiga machines (500/1000/2000/2500/3000).
  32.  
  33.     * Amidock supports an unlimited number of buttons. The buttons are kept in
  34.       a single line (column or row) and can extend beyond the screen boundaries
  35.       with the use of the two scroll arrows.
  36.  
  37.     * AmiDock can be moved around the screen like any normal window, and
  38.       can be configured as a vertical column or a horizontal row. 
  39.  
  40.  
  41.   Ok, now what do you need to get up and running with the program? 
  42.  
  43.         1) You will need a copy of the arp.library in your LIBS: directory. 
  44.            This has been included. AmiDock uses the arp.library for it's file
  45.            requester.
  46.  
  47.         2) You will need to copy the AmiDock program to your C: directory.
  48.  
  49.         3) Copy the Dock directory to your hard drive or your WorkBench
  50.            Boot Floppy. The Dock directory contains the following files and
  51.            directories:
  52.  
  53.                      Dock/
  54.                            Interlace/
  55.                                       DockImageGrid2.iff
  56.                                       MainDock/
  57.                                                 <misc brush files>
  58.                                                 dock.config
  59.                            Non-interlace/
  60.                                          DockImageGrid1.iff
  61.                                          MainDock/
  62.                                                   <misc brush files>
  63.                                                   dock.config
  64.  
  65.         4) Lastly assign DOCK: to the directory where the configuration file and 
  66.            the brushes are kept. This will be either the "Dock/Interlace/Maindock/"
  67.            directory or the "Dock/Non-Interlace/Maindock/" directory depending on
  68.            if you run your workbench in interlace mode or not. The only difference
  69.            in the files are the size of the brushes. The interlace versions are
  70.            larger than the non-interlace ones. Either one will work on any screen
  71.            (interlaced or not). AmiDock when run from the workbench uses the DOCK:
  72.            assignment to find its config file and brushes. This assignment should
  73.            be added to your startup-sequence. AmiDock will also use the DOCK:
  74.            directory if run from the CLI with no argument given. The only argument
  75.            AmiDock takes is the path to it's config file.
  76.  
  77.         5) execute AmiDock.
  78.  
  79.         6) AmiDock comes pre-configured to run a variety of programs. You will
  80.            want to re-configure the dock to run the programs you have.
  81.            
  82.            
  83. Misc Stuff
  84.  
  85.   In this release the brushes associated with a given dock.config file must be in
  86. the same directory as that dock.config file. The brush requester will allow you to
  87. enter a brush from a different directory, but AmiDock will not recognize the brush
  88. if it is not in the same directory as it's dock.config file.
  89.  
  90.   AmiDock does not need to be "run", it will set itself up as a background process 
  91. and return control to the CLI. AmiDock can be added to your startup-sequence and it
  92. will allow the startup CLI to close. If you are using AmigaDOS2.0, AmiDock can be 
  93. placed in the wbstartup drawer, just remember to add a tool type of DONOTWAIT to
  94. AmiDock's icon.
  95.  
  96.   AmiDock accepts 1 argument when run from the CLI. This is the path to the config
  97. file and brushes. ex: amidock dh0:dock/interlace/maindock - this will use the path
  98. "dh0:dock/interlace/maindock" as the path to the config file. If AmiDock is run with
  99. no arguments it will use the DOCK: assignment.
  100.  
  101.   The Text button in the Add/Edit/Delete window does not work.  (yet..)
  102. Pressing it will not cause any change in operation, AmiDock will still use the 
  103. brush.
  104.  
  105.   Included in this distribution should be two files called "DockImageGrid1.iff"
  106. and "DockImageGrid2.iff". They are non-interlaced and interlaced respectively.
  107. These files are IFF ILBM pictures of many pre-defined button image's and a bunch
  108. a blank ones that you can fill in with your own designs. To create a new brush or
  109. add a pre-defined one, load the DockImageGrid?.iff into a paint program (DPaint),
  110. draw your new brush inside one of the blank buttons or find a pre-defined you like,
  111. and grab it as a brush. Make sure that the edges of the brush are the edges of the
  112. button. Save the brush in the directory of the dock you want to use it on. If you
  113. come up with any interesting brushes be sure to upload them or mail them to me so
  114. I can include them with future releases of AmiDock.
  115.  
  116.   I want to say a word of thanks to the management of Soft-Logik Publishing Corp.
  117. for the use of their facilities in the distribution of AmiDock.  While this is
  118. not in anyway a product of Soft-Logik's they have nonetheless been very supportive 
  119. of me while I was developing it (by giving me a day job).  A special thanks to
  120. Deron Kazmaier, Dan Weiss, Brad Kazmaier and  Mike Loader for their help in 
  121. seeing AmiDock born.
  122.  
  123.   Last but not least, AmiDock is a shareware program. AmiDock is not Public 
  124. Domain or Freeware. AmiDock is freely re-distributable providing all the files in
  125. this distribution are kept intact. Please give (do not sell) AmiDock to anyone you
  126. like. As stated, AmiDock is a shareware program and as such I request a fee of 
  127. $25.00 if you use this program. 
  128.  
  129.   When I receive your monetary contribution I will make you a registered user
  130. and send you a "real" manual  that explains in greater detail the workings of  
  131. AmiDock and the latest version of the program. As a registered user you will be 
  132. entitled to free upgrades (via on-line services) as long as AmiDock remains a 
  133. shareware product and a discount if (and hopefully when) AmiDock goes commercial.
  134. If you are registered and would like a copy of the latest version from me, just send
  135. a blank floppy and a SASE that can hold the floppy, and I will send you the latest 
  136. free of charge. I have big plans for AmiDock, but they will only be realized if the
  137. product gets support from the Amiga community.
  138.  
  139.   Well that's about all for the readme file. A complete description of the 
  140. program and all it's features will be supplied in the manual which you will receive 
  141. when you send in your registration card (see below) and money. Please mail the 
  142. card and your payment (check (drawn on a US bank), money order payable to me (in
  143. US Funds), or cash) at the address listed below:
  144.  
  145.  
  146.                         Gary Knight
  147.             3200 Patterson Place Dr #307
  148.             St.Louis, Mo. 63129
  149.  
  150.  
  151.   I hope you find this program useful!  If you have any comments or bug 
  152. reports I can be reached by e-mail on:
  153.  
  154.                         GENIE: Deron.K
  155.                         CIS: 76317,3633
  156.                         BIX: dkazmaier
  157.                         Soft-Logik BBS: Quill, or #292
  158.  
  159. You can also drop me a letter at the address listed above.
  160.                             
  161.  
  162.                             Thank You!!!!
  163.  
  164.  
  165. PS: Here is a list of the new features/fixes in AmiDock 1.4.1:
  166.     (which you will receive when you register)
  167.         
  168.         
  169.         - added support for drop in icons under wb2.0. To add a new item just
  170.           drag the icon over to the dock and drop it on the dock's window and it
  171.           will be added using the icon for an image.
  172.         
  173.         - now it uses GetDiskObject to load the icon's imagery instead of reading
  174.           the file directly.
  175.           
  176.         - bug fixes involving memory not being freed under some conditions.
  177.         
  178.         - added support for using icons for bay images.
  179.         
  180.         - added support for using text for bay images (including font and color
  181.           control if running under wb2.0).
  182.         
  183.         - some internal re-works, code cleanup, and optimizations.
  184.         
  185.         - eliminated all need for the arp.library if running under wb2.0!
  186.           (and there was much rejoicing)
  187.           
  188.           * AmiDock uses the ASL file requester.
  189.           * AmiDock uses the ASL font requester.
  190.           * AmiDock uses the DOS Execute() call when running a program as a CLI
  191.             style process.
  192.         
  193.         - when AmiDock is the active window the WB screen title bar now has the
  194.           word "AmiDock" in it. (this goes for the select and edit windows also)
  195.         
  196.         - when AmiDock is launching a program it puts a message in the WB screens
  197.           title bar that reads "Attempting to load 'program name'..." like wb2.0.
  198.           
  199.         - the prop gadget in the Dock Item Selector window now uses the PROPNEWLOOK
  200.           flag for the new and improved wb2.0 look.
  201.           
  202.         - put in much more comprehensive error handling and reporting.
  203.         
  204.         - if the icon image is used, the name of the ".info" file is taken from the
  205.           path+appname+".info". It no longer uses the string gadget's contents
  206.           to get the ".info" file.
  207.           
  208.  
  209.  
  210.                         cut here and return with payment
  211. -----------------------------------------------------------------------------------
  212.  
  213.  
  214.                              USER  REGISTRATION  CARD
  215.  
  216.  
  217.         Product: AmiDock v1.3
  218.  
  219.  
  220.         Name:_____________________________________________________________
  221.  
  222.         Address:__________________________________________________________
  223.  
  224.         City:___________________________________ State:___________________
  225.  
  226.         Country:__________________________ Postal Code:___________________
  227.         
  228.  
  229.         Workbench version:________________________________________________
  230.         
  231.         
  232.         Description of Hardware:__________________________________________
  233.  
  234.         __________________________________________________________________
  235.  
  236.  
  237.         Primary Use of Hardware:  ___Home   ___Business   ___Fun  ___Other
  238.  
  239.     
  240.         Comments:_________________________________________________________
  241.  
  242.         __________________________________________________________________
  243.  
  244.         __________________________________________________________________
  245.  
  246.         __________________________________________________________________
  247.  
  248.         __________________________________________________________________
  249.     
  250.         __________________________________________________________________
  251.